package com.gobang.domain.vo;

import com.gobang.common.exception.ErrorCode;
import com.fasterxml.jackson.annotation.JsonInclude;

import java.io.Serializable;

/**
 * 通用返回结果类
 * 提供统一的API响应格式，支持泛型数据和分页信息
 * 
 * @param <T> 数据类型
 * @author System
 * @since 1.0.0
 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public class Result<T> implements Serializable {

    private static final long serialVersionUID = 1L;

    /**
     * 响应码
     */
    private String code;

    /**
     * 响应消息
     */
    private String message;

    /**
     * 响应数据
     */
    private T data;

    /**
     * 时间戳
     */
    private Long timestamp;

    /**
     * 请求路径
     */
    private String path;

    /**
     * 分页信息
     */
    private PageInfo pageInfo;

    /**
     * 私有构造函数
     */
    private Result() {
        this.timestamp = System.currentTimeMillis();
    }

    /**
     * 私有构造函数
     */
    private Result(String code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
        this.timestamp = System.currentTimeMillis();
    }

    /**
     * 成功响应 - 无数据
     *
     * @param <T> 数据类型
     * @return 成功响应
     */
    public static <T> Result<T> success() {
        return new Result<>(ErrorCode.SUCCESS.getCode(), ErrorCode.SUCCESS.getMessage(), null);
    }

    /**
     * 成功响应 - 带数据
     *
     * @param data 响应数据
     * @param <T> 数据类型
     * @return 成功响应
     */
    public static <T> Result<T> success(T data) {
        return new Result<>(ErrorCode.SUCCESS.getCode(), ErrorCode.SUCCESS.getMessage(), data);
    }

    /**
     * 成功响应 - 自定义消息
     *
     * @param message 响应消息
     * @param <T> 数据类型
     * @return 成功响应
     */
    public static <T> Result<T> success(String message) {
        return new Result<>(ErrorCode.SUCCESS.getCode(), message, null);
    }

    /**
     * 成功响应 - 带数据和自定义消息
     *
     * @param data 响应数据
     * @param message 响应消息
     * @param <T> 数据类型
     * @return 成功响应
     */
    public static <T> Result<T> success(T data, String message) {
        return new Result<>(ErrorCode.SUCCESS.getCode(), message, data);
    }

    /**
     * 失败响应 - 使用ErrorCode
     *
     * @param errorCode 错误码枚举
     * @param <T> 数据类型
     * @return 失败响应
     */
    public static <T> Result<T> error(ErrorCode errorCode) {
        return new Result<>(errorCode.getCode(), errorCode.getMessage(), null);
    }

    /**
     * 失败响应 - 使用ErrorCode和自定义消息
     *
     * @param errorCode 错误码枚举
     * @param message 自定义错误消息
     * @param <T> 数据类型
     * @return 失败响应
     */
    public static <T> Result<T> error(ErrorCode errorCode, String message) {
        return new Result<>(errorCode.getCode(), message, null);
    }

    /**
     * 失败响应 - 直接指定错误码和消息
     *
     * @param code 错误码
     * @param message 错误消息
     * @param <T> 数据类型
     * @return 失败响应
     */
    public static <T> Result<T> error(String code, String message) {
        return new Result<>(code, message, null);
    }

    /**
     * 系统错误响应
     *
     * @param <T> 数据类型
     * @return 系统错误响应
     */
    public static <T> Result<T> systemError() {
        return error(ErrorCode.SYSTEM_ERROR);
    }

    /**
     * 参数错误响应
     *
     * @param message 错误消息
     * @param <T> 数据类型
     * @return 参数错误响应
     */
    public static <T> Result<T> paramError(String message) {
        return error(ErrorCode.PARAM_ERROR, message);
    }

    /**
     * 数据不存在响应
     *
     * @param <T> 数据类型
     * @return 数据不存在响应
     */
    public static <T> Result<T> dataNotFound() {
        return error(ErrorCode.DATA_NOT_FOUND);
    }

    /**
     * 设置分页信息
     *
     * @param pageInfo 分页信息
     * @return 当前结果对象
     */
    public Result<T> withPage(PageInfo pageInfo) {
        this.pageInfo = pageInfo;
        return this;
    }

    /**
     * 设置请求路径
     *
     * @param path 请求路径
     * @return 当前结果对象
     */
    public Result<T> withPath(String path) {
        this.path = path;
        return this;
    }

    /**
     * 判断是否成功
     *
     * @return 是否成功
     */
    public boolean isSuccess() {
        return ErrorCode.SUCCESS.getCode().equals(this.code);
    }

    // Getter and Setter methods
    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }

    public Long getTimestamp() {
        return timestamp;
    }

    public void setTimestamp(Long timestamp) {
        this.timestamp = timestamp;
    }

    public String getPath() {
        return path;
    }

    public void setPath(String path) {
        this.path = path;
    }

    public PageInfo getPageInfo() {
        return pageInfo;
    }

    public void setPageInfo(PageInfo pageInfo) {
        this.pageInfo = pageInfo;
    }

    @Override
    public String toString() {
        return "Result{" +
                "code='" + code + '\'' +
                ", message='" + message + '\'' +
                ", data=" + data +
                ", timestamp=" + timestamp +
                ", path='" + path + '\'' +
                ", pageInfo=" + pageInfo +
                '}';
    }
} 